home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 2 / Amiga Tools 2.iso / tex / macros / source / base / emtex.txt < prev    next >
Text File  |  1995-03-15  |  4KB  |  122 lines
  1.            LaTeX installation instructions for emTeX
  2.     
  3.                         30 May 1994
  4.  
  5.  
  6. SUMMARY
  7. =======
  8.  
  9. This file contains instructions on how to install LaTeX for emTeX on
  10. DOS; users of emTeX on OS/2 will need to make the standard small
  11. changes, such as `.cmd' instead of `.bat'.
  12.  
  13. Before reading this file, you should read install.txt, which will
  14. explain how the LaTeX installation works.
  15.  
  16. This file describes:
  17.  
  18.  * How to save any old version of LaTeX.
  19.  
  20.  * How to unpack the LaTeX distribution.
  21.  
  22.  * How to create the LaTeX format.
  23.  
  24.  * How to install the LaTeX files.
  25.  
  26. These instructions assume that you are using the standard directory set
  27. up supplied by the emTeX distribution.  We hope that, if your system's 
  28. set up differs from this then you will be sufficiently familiar with
  29. your system to make the necessary amendments to these instructions.
  30.  
  31.  
  32. SAVING ANY OLD VERSION OF LATEX
  33. ===============================
  34.  
  35. If you have a copy of LaTeX 2.09, you may wish to save it before 
  36. installing the new LaTeX.  
  37.  
  38. You should make a subdirectory called latex209 in the emtex directory.
  39. Then copy any files called *.sty from the TeX inputs directory
  40. (normally emtex\texinput) into this latex209 subdirectory.  You should
  41. also rename the LaTeX format file which you use for LaTeX 2.09,
  42. usually lplain.fmt, to latex209.fmt.
  43.  
  44. You should then create a batch file latex209.bat, which temporarily
  45. resets the TEXINPUT environment variable to a path which includes the
  46. latex209 subdirectory before the TeX inputs directory, and then calls
  47. TeX with the file latex209.fmt as the format file.  Check that this
  48. batch file works before proceeding.
  49.  
  50.  
  51. UNPACKING THE DISTRIBUTION
  52. ==========================
  53.  
  54. To unpack the LaTeX distribution, you should change to the directory
  55. reserved for the installation and run iniTeX on the file unpack.ins.
  56. To run iniTeX you use the  option /i so this is typically done by
  57. typing:
  58.  
  59.    tex /i unpack.ins
  60.    
  61.  
  62. CREATING THE LATEX FORMAT
  63. =========================
  64.  
  65. To create the LaTeX format, you should run iniTeX on the file
  66. latex.ltx.  This will create a file latex.fmt.
  67.  
  68. You should copy this to the directory where TeX looks for its format
  69. files, normally the texfmts or btexfmts subdirectory of emtex.  Make
  70. sure that you put it in the correct directory: the one that is used by
  71. the version of the TeX program you are using.
  72.  
  73.  
  74. PUTTING THE FILES WHERE LATEX CAN READ THEM
  75. ===========================================
  76.  
  77. You should move the following files to the TeX inputs directory
  78. (usually emtex\texinput):
  79.  
  80.    latexbug.tex  testpage.tex  docstrip.tex
  81.    *.cls  *.clo  *.sty  *.fd  *.def  *.cfg
  82.  
  83. If you use the MakeIndex program (called makeindx.exe) then you should
  84. move the *.ist files into the MakeIndex inputs directory (normally
  85. emtex\makeindx).
  86.  
  87.  
  88. CHECKING THAT THE INSTALLATION WORKED
  89. =====================================
  90.  
  91. You should now run LaTeX on ltxcheck.tex.  This should produce a
  92. number of `OK' messages.  If it produces any warnings, please consult
  93. the `Problems' section of the file install.txt.
  94.  
  95.  
  96. MEMORY PROBLEMS
  97. ===============
  98.  
  99. If you have an old version of emTeX, or you are using a PC with a CPU
  100. less powerful than an 80386, then you will need to increase that part
  101. of the memory known as `string characters' or as `pool size'.
  102.  
  103. This should be set to its maximum value by using the option:
  104.  
  105.   /mp:65500
  106.  
  107. either on the command line or via the EMTEXOPT environment variable.
  108.  
  109. You will probably be able to compensate for this increased
  110. requirement by reducing the `font info' memory using the
  111. option `/mf:'.
  112.  
  113. When using several packages or when processing complex documents,
  114. especially if they contain lots of cross-references, citations, etc.,
  115. you may run out of the memory known as `multiletter control sequences'
  116. or as `hash table'.  Unfortunately, the only cure for this is to get a
  117. newer version of emTeX.
  118.  
  119. --- Copyright 1994 the LaTeX3 project ---
  120. ---       All rights reserved.        ---
  121.  
  122.